home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / arc_st.hlp < prev    next >
Encoding:
Text File  |  1986-10-05  |  6.8 KB  |  159 lines
  1. ARC Introduction and short docs.
  2.  
  3.           ARC (short for archive) is a file library and compression
  4.           utility.  It may be thought of as an improved version
  5.           of LU and SQUEEZE all rolled into one program.
  6.  
  7.           ARC analyzes each file to see which of a number of
  8.           compression techniques will generate the smallest code.
  9.           The following estimates give the user a general idea of
  10.           how much compression may be gained by using ARC.
  11.  
  12.                 ARC Text -            45-55% reduction from original
  13.                 SQUEEZED Text -       30-40% reduction
  14.  
  15.                 ARC Programs -        25-30% reduction
  16.                 SQUEEZED Programs -   15-20% reduction
  17.  
  18.                 ARC Pictures -        45-55% reduction
  19.                 SQUEEZED Pictures -   40-50% reduction
  20.                 TINY Pictures -       40-50% reduction
  21.  
  22.           The user should see that compressing files with ARC
  23.           will allow easier telecommunications by combining files
  24.           and shortening their transfer time.
  25.  
  26.      Usage from TOS
  27.           - double-click-left on ARC.TTP icon
  28.           - observe OPEN APPLICATION menu for ARC.TTP parameters
  29.           - enter switch, archive name and file template
  30.             (ex: lh arc.arc *.*)
  31.           - hit return or click-left on OK box to begin execution
  32.           - "press any key to continue" after completion
  33.  
  34.      History
  35.           ARC has been in use in the CP/M and MS-DOS world for many
  36.           years.  Thom Henderson developed the version which I
  37.           converted for use on the Atari ST.  I am not sure but he
  38.           may also be the original author.
  39.  
  40.           It is important to note that no matter who developed this
  41.           program, ARC is based on the file compression theories
  42.           developed by Huffman, Welch, Knott, Knuth, and many other
  43.           scientists.
  44.  
  45.      Bug Reports
  46.           Since I developed this version of ARC, I will be responsible
  47.           for any erroneous features.  Please relay any problems with
  48.           a written discription of what happened and the .ARC file
  49.           which caused the problem to:
  50.  
  51.                         Harvey Johnson
  52.                         2398 Oaklyn St NE
  53.                         Palm Bay, FL 32907
  54.  
  55.                              - or -
  56.  
  57.                       QUILL BBS 305-724-2303
  58.  
  59.  
  60.      Future Products
  61.           It would be nice to have a version of ARC written to utilize
  62.           GEM.  I would also like to write a picture display feature
  63.           that will show compressed pictures directly to the screen.
  64.           This will be useful in that ARC squeezes file 5 to 10% smaller
  65.           than TINY format.  If anyone has the C source to dump NEO,
  66.           Degas, or other pictures to the screen please upload a copy
  67.           to QUILL BBS.
  68.  
  69.           If you have any ideas for additional capabilities, then send
  70.           them to me with a detailed explanation.  All thoughts are
  71.           welcome.
  72.  
  73.      Donations
  74.           It would be nice to be supported if you think that ARC
  75.           is any good.  Make no mistake, I did NOT write the original
  76.           version of ARC, but I have spent all my extra time for
  77.           two months making it a reality on the Atari ST.
  78.  
  79.           As I do recieve contributions, I will consider improvements
  80.           more seriously.  Any donations may be sent to address
  81.           specified in Bug Report section.
  82.  
  83.           Thank you one and all in advance for considering this
  84.           request, but if you are like me (lazy) then I don't
  85.           really expect to ever see a single dime.
  86.  
  87. ARCHIVE (ARC.TTP)
  88.  
  89.      Usage
  90.           arc {amdxelvth} <filename.ARC> [<filename> ...]
  91.  
  92.                a   = add files to archive
  93.                m   = move files to archive
  94.                d   = delete files in archive
  95.                x,e = extract files from archive
  96.                l   = list files in archive
  97.                v   = verbose listing of files in archive
  98.                t   = test archive integrity
  99.                h   = hold screen before returning to Desktop
  100.  
  101.      Description
  102.           This program is a general archive utility, and is
  103.           used to maintain an archive of files.  An "archive"
  104.           is a single file that combines many files, reducing
  105.           storage space and allowing multiple files to be
  106.           handled as one.
  107.  
  108.      Switches
  109.  
  110.           a - add files to archive.  This switch will force update
  111.               or addition the indicated reguardless of creation
  112.               time and date.
  113.  
  114.           m - move files to archive.  Same as "a" switch except
  115.               that the files are deleted from the directory as
  116.               they are moved to the archive.
  117.  
  118.           d - delete files in archive.  The files are lost forever
  119.               and the archive is recompacted to remove the data
  120.               for these files.
  121.  
  122.           x,e - extract files from archive.  A copy of the files
  123.               in the archive are created in the current directory
  124.               in an uncompacted state.
  125.  
  126.           l - list files in archive.  Limited information listing
  127.               of files contained in an archive.  Displays only the
  128.               filename.
  129.  
  130.           v - verbose listing of files in archive.  Complete
  131.               information listing of files contained in an archive.
  132.               Displays the filename, original length, storage method,
  133.               storage factor (% savings), compacted size, date, time,
  134.               and CRC.
  135.  
  136.           t - test archive integrity.  Check the archive to make sure
  137.               it does not have any bad files contained.
  138.  
  139.           h - hold screen before returning to Desktop.  This switch
  140.               should be used whenever ARC is executed from the
  141.               Desktop, except in conjunction with file redirection.
  142.  
  143.      Examples when executed from GEM Desktop:
  144.  
  145.      ah FILES.ARC *.PRG      Creates a new archive file called FILES.ARC
  146.                              and puts all files ending in .PRG inside.
  147.  
  148.      xh FILES.ARC *.*        Extracts all files from FILES.ARC.
  149.      xh FILES.ARC            ""
  150.      xh FILES                ""
  151.  
  152.      xh FILES.ARC *.DOC      Extracts all files ending in .DOC.
  153.  
  154.      In each case, the 'h' holds the display instead of immediately returning
  155.      to the GEM Desktop so you can view filenames, messages, etc.  More
  156.      complete docs are in the ARC.ARC archive file.  These are just to help
  157.      you get started.  ARC seems to be the most reliable of the 'masher'
  158.      programs and has the best overall size reduction.
  159.